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PRODUCT SPECS/USER MANUALS | | R. Gonzalez 


I've attached a list of how I view our responsibility to product specifications. 
In essence, all compilers will have two product specs, being 


a) 


b) 


The appropriate S-language 


The compiler product spec 


The compiler product spec should address itself to 


a) 
b) 
c) 


*d) 


kee) 


Notes: 


A global description of the compiler 
Resources taken (memory/disk, etc.) 


Approximate performance or performance formulae 


Compiler directed controls ($ cards, conditional compilation, etc.) 


Reference to the source syntax and semantics to a standards manual 
or user manual as appropriate. 


* This portion will be duplicated in the product spec and user manual 
but, hopefully, will be static in nature. 


** By referencing the source syntax/semantics in this fashion, the 
product specification will tend to be a stable document. 


It is most desirable that once a standards manual/user inanual is prepared for a 
software product, that the newly formed TRANSACTION scheme will provide the 
vehicle to update the appropriate document by persons other than the developers. 


This is just another topic that indicates that if we document the TRANSACTION/ 
TROUBLE reports well at development time, we can get out of the business of 
updating documents. . 


F. Alan Goodman, Manager 
Language Development 
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These are the items that you're to finer up prior to transferring into the 
MIL pompetes projects 


1. Run extended disk diagnostics successfully. 
2. Run extended arithmetic diagnostics successfully. 


3. Add PE tape capability. This should be done such that the 
emulator can run with 2K M-memory. 


4, Add 7-track capability. 
5. Add SCAN DISK capability. 


6. Determine the disposition of two pages of miscellaneous issues 
with Dave Krajcar with respect to frequency of use, etc. 


7. Complete documentation input to the above including product 
spec PS#2204-8680. 


Rich Belgard will assume general project support at the completion of the 
above and in addition will 


1. Add SYSOUT capability. 
The following represents items that will be considered for later: 


1. A discussion of COLUMN BINARY by Dave Krajcar in case this is 
to be implemented in the future. 


2. To run 1401 COBOL. This would be dasirable to do but would, 
in no way, hold up the emulator product. 


3. To run 1401 F.A.S.T. This again would be desirable but may not 
by possible due to the absence of COLUMN BINARY. 
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4. Remove any machine dependancy in the emulator, i.e., make a 
single 1714/1726 emulator product. 


F, Alan Goodman, Manager 
Language Development 
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To: Al Goodman 

From: Larry Thomas 

Subject: MIL Compiler _ ee. Hank Havery 
| \ Rex Kerley 


Don McCrea 


In anticipation of turning the MIL Compiler over to the 
Implementation Language Group,I have prepared a list of problems and 
suggestions for the compiler (attached). In general, compilation speed , 
at least on larger machines, seems to be adequate (up to 1500 CPM). 
Unless pressure exists to improve speeds on smaller machines, most 
effort in the near future should be concentrated on: 

1. Making the compiler more reliable. 


2. Making the output more responsive to users needs, 


3. Making the language easier to. use. 


The compiler is generally in pretty good shape. There are problems 
however, and some of these problems are more important than others, 
I have organized the attached list into six arbitrary categories. 
These are: 

Hi priority problems (only relatively speaking) 

‘Medium priority problems 

Error reporting problems 


dé 

Zé 

oe 

4. Hi priority suggestions 

5. Medium priority suggestions. 
6. 


Speed improvement suggestions, 
Larry Thomas 


Implementation and Virtual Machine Section 


Language Development Department. 


HI PRIORITY PROBLEMS 


The MIL users manual is in bad shape. Progress on the BNE version is 
satisfactory but it should be completed as soon as possible. Scheduled 


completion is currently December, 1974, 


The mechanism which generates a listing needs to be re-written. This 
mechanism essentially has to merge four components: code, code parameters, 
source, and source listing parameters, Only the first three components 
are well defined. The fourth component availability and the merging 
mechanism itself are ill conceived and should be redone. Some specifics 
associated with this problem are: 

1. Printing the addresses of local declare elements is clumsy. 

2. If the LIST $ option is turned off at the beginning of a compilation 
and is later turned on and the pre~pass is listed then the final 
listing does not contain a heading, 

3. Page numbers get messed up when $ LIST is turned on and off, 

4, An entire page of source only code at the beginning of a source 
file causes the headings to print at the wrong time on the 
listing, | | 

5. The following sequence of cards results in the last one not 
being printed. 

$LIST 
% 
FINI 


6, Whenever the compiler is running on a machine with a bad disk, 
and the bad disk causes the information contained in one of the 
four components to be wrong, then the entire listing is messed 
up starting from the point in error, This seems to ha ppen 


quite frequently on some of our machines. 


The code that generates the parameter blocks allows only a limited amount 
of space for conditional inclusion names. This currently causes problems 


when MIL analyzer is run against GISMO object files. 


MEDIUM PRIORITY PROBLEMS 


$ FORCE does not work correctly because some errors seem to cause a 
lot of the branch addresses in the code file to be incorrect, The 


exact cause of this problem has not been identified. 


IF-SKIP optimization needs to be reviewed. There seems to be some not 
uncommon times when the compiler does not generate optimal code when it 


should, (Hank Havery and Alan Grubb have some examples) 


When adding a new reserved word to the compiler, the item in the symbol 
table is not truncated to the size that an incoming source item would be. 


This is an inconvenience for the person modifing the compiler. 
$NO COMPILE does not list $ cards even when $ DOLLAR is specified. 


An external label reference before any non external label reference. or 
declaration causes the compiler to loop when it encounters the first 
CODE, SEGMENT statement. Appears to be a problem only in test cases 


but should be fixed pronto. 


The following code will not generate what the user wants and, depending 
on the block name, may not generate a syntax error, The only solution 
may be to spell out the problem in the users manual. 

IF SUBSET THEN INCLUDE 

BEGIN SUBSET 


END ELSE SUBSET 
BEGIN NOT, SUBSET 


END NOT, SUBSET 


The compiler will not accept all legal system file names on the 
& LIBRARY card . 


ERROR REPORTING PROBLEMS 


An error occurring within a TABLE statement causes the compiler to get lost . 
Other strange errors then get reported thus confusing the issue, The 
compiler should probobly try to scan to the END associated with the 


TABLE statement when it finds this kind of error, 


Errors in strings should point at the character in error rather than 


at the string terminator. 


Empty strings generate different errors depending on whether or not it is a 


MOVE or WRITE.STRING statement. Should be consistent, 


A string with no closing bracket in a MOVE or WRITE.STRING statement 


generates an inappropriate error message. 


Better:checking of what can and cannot be changed on $ cards after a 
compilation begins needs to be looked into, Perhaps should not allow 
change after an option has bem referenced by the compiler or used by the 


user, Otherwise change would be OK, 


HIGH PRIORITY SUGGESTIONS 
Add patch control facility. 


Allow arithmetic expressions in the remaps and length portions of 


the DECLARE statement. 


Do. something about problem of branch out of range conditions in long 


programs. (See TR NOO102), 
Supply a warning message when void range overlaps card patches. 


Supply an error message when VOID begin seq no. is greater than VOID 


' end seq. no, \ 


Add "specials" so that words that are currently reserved could be 


defined by the user. 


Add a VALUE statement to the DECLARE statement. This should eliminate 
TABLES in many cases, 


Separate the ERROR file from the regular listing file. 


MEDIUM PRIORITY SUGGESTIONS 


Give the user the ability to specify (via $ options) which subset of the 
following items he would like displayed on his Listing on a line 

by line basis. (Segment names, Block names, Some other user specified name, 
BEGIN-END nesting level, Output card sequence number if asked for punched 
deck, Code address relative O° he beginning of the code file, Code 

address relative to the current code block), The problem with this 

whole thing is that there is not enough room on the listing, so some 


trade offs will have to be made. 


Optionally produce output similar to that produced by the MIL ANALYZER 


with each listing. 


Provide syntax independent conditional inclusion mechanism. 


(perhaps similar to SDL's facility). 
Provide @ more general segmentation facility. (See Alan Grubb for his ideas). 
Optimize segment handling to avoid emitting un-needed code. 
Allow arbitrary boolean expressions to appear in IF ... INCLUDE statements. 
Add new syntax to eliminate the error prone,unappealing, and unreadable 
constructs: 

BIAS,,. TEST 

INC, o ‘e fEST 

DEC, ,-. TEST 


Add subtitles to listing that can be changed dynamically. 


Consider eliminating the level emitting at the end of the program, 


Need to poll users to see if it is used. 


Provide a more general way of emitting a hash checking micro. 


Provide better syntax to make it easier for the user to specify the 


level ‘of his program. 


MEDIUM PRIORITY SUGGESTIONS (continued) 
Add a continuation card facility. Perhaps -% would do for syntax. 
Add TRACE pseudos for use with MIL emulator, 


ADD a facility which would allow over-riding of $ cards which are embedded 


in the source, Examples $LIST - $NO. LIST, $SEQ ~- $NO SEQ, 


SPEED IMPROVEMENT SUGGESTIONS 


Provide library object files. Currently we have onky library source files. 
This should not be too hard to do and it would help diagnostics and 


emulators which end up having to re-compile I/O drivers over and over again 


Re-write scanner to make more modular and to use the new scan S-ops. The 
current scanner is the original one written three and a half years ago. 
When this is done, another pass should probably be added to perform 

all of the scanning before code emitting begins, This. should improve 


compilation speed in small machines, 


Investigate reorganization of reserved words and perhaps initial declarations 
in the symbol table so that items that hash to the same stack head reside 
in the same page or in contiguous pages, This should reduce page faults. 


The SEARCH, SERIAL, LIST op might then be used to good advantage also. 


Handling of the macros should be investigated. Some space is wasted 
when the macro records are stored away. The new POSITION communicate 


would also be advantageous in speeding up macro processing. 


5 Sept. 1974 


To: Distribution 
From: Larry Thomas 


Subject: Overview of MIL COMPILER Organization . 


cc: 
Al Goodman 
Hank Havery 
You are invited to attend a class which will briefly cover the 

overall organization of the Mil Compiler. The class will be held on 
Monday and Tuesday, Sept. 9 and 10, 1974, from 2:30 to 4:30 in the 
new conference room (by Mr. Bunker's office). Monday's class will 
cover in very general terms the compiler's organizaticn. Tuesday's 


session will be reserved for detailed questions and answers, 


Larry Thomas 
Implementation and Virtual Machine Section 


Language Development 


Distribution: 
Dennis Austin 
Rex Kerley 
Don McCrea 
Dick Palmer 


Chip Pardini 


OPERATION OF THE 
MIL COMPILER 


7 - INITIALIZE O+603000— OFS12 3000 

II COMBILE.IT.ALL -- the compile phase 0946000 — (OBOE 
mente WRAP.UP. COMPILE (0 91 Goce 

IV _CLEAN.UP.LABELS -- the fixup phase 12944 v0 

V . GENERATE.ALL,OUTPUT.FILES -- the listing phase t\R4s000 


The MIL compiler is generally considered a one pass compiler since 
all symbol table lookup and 90% of the code generation is done in the 
compile phase. 
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INITIALIZE Ab6 O 


A. Global variables 
B. Main symbol table 


C. Compile phase files 


IL COMPILE. LT. ALL | AVoe 


A, Makes an initial call on READACARD which 
ie Hewes $ cards until lst non-~$ card 
2. Calls on INITIALIZE.COMPILE to 
a) lock in some $ spe iaslea: MERGE) 
b) get the time and COMPILE.CARD, INFO 
s start eit the xref and release tape processes 
B. Handles all source records 
1. Handles label declarations 
2. Scans for the keyword(e.g. MOVE), looks it up in the symbol 
table and uses symtype to select a particular case in the 
big COMPILE.,IT.ALL case statement 
| 3. Each keyword case 
| a) handles its own semantics by individually driving 
1) the scanner 
2) the code emitter 
3) the code parameter emitter 
b) handles most of its own error checking 


4. Generates the preliminary listing file, LINESAVE, on disk 


ITil 


WRAP ..UP. COMPILE | [ O 4) OV 


A. 


B. 


C. 


Completes and closes compile phase files 
Checks for FINI record 
Closes out any open code segments 


Zips MIL/XREFER if not $ RELEASE 


IV CLEAN .UP.LABELS [ 202 


A. 


D. 


Changes the code parameter file, PARAM.FILE, to a random file so 
that it can be read backwards to pinta the jetaisabton 

The first part uses the code parameter file and the COMLAB 

table to factor in the effects of SEGMENT and ADJUST statements. 
At this time, COMLAB.ADDR is changed to be ae code address 

the label was seswe rated with in the compile phase(copied from 
PARAM. FILE). At the same time, adjustments to this code address 


are accumulated in another field in the COMLAB table. 


The second part, FINISH.CLEANUP.PASS, massages the COMLAB table to 
/xeflect the actual final addresses to be associated with each 


: Label. This information is put into COMLAB.ADDR. 


The PARAM.FILE is changed back to a serial file and the symbol table 


is searched for Labels which were referenced but never declared. 


V 


GENERATE, ALL. OUTPUT. FILES | 8 4) bo ( (whey Lodo ( 2 rar) 


A. 


B. 


SET.UP.OUTPUT. PASS initializes listing phase variables and files 

GENERATE, TEMP.CODE.FILE.AND.LISTING merges the information from 

the compile phase contained in the code(CODE.FILE), Listing(LINESAVE) 

and code parameter(PARAM.FILE) files. It uses. these files and the 

COMLAB table to simultaneously generate 

l. The stiae 

2, The ice portion of the RELEASE tape 

3. The code portion(no PPB, IPB, etc.) of the final code file by 
emitting extra code for IF's that branch more than 15 words, 
special LOAD options, etc. 7 

BUILD. CODE. FILES slepies the final code file by adding the PPB, IPB, 


conditional include block, correspondence table and segment dictionaries 


to the TEMPCODEFILE produced in B.3 above, and punches an object 


‘deck if $ DECK was specified 


D. Finishes up the RELEASE tape by adding the punch, code, source and 


xref files and thens zips MIL/XREFER(if $ RELEASE was specified) 
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MIL 
DEFINE HANDLING 


When a DEFINE statement is encountered in the source, the define string 
is placed into a paged array reserved for define strings, and the defined 
token is inserted into the symbol table along with address and length info 


about the associated define string. 


The scanner, in general, looks up every symbol in the symbol table. 
When it encounters a defined symbol, it will locate the define string, 
copy it into the next available location in a 100 byte define buffer, 
save current information about the scan pointer in a stack, change the 
scan pointer to point to the beginning of the define string in the 
define buffer, and finally recursively call the scanner to scan the 
first token in the define string(the procedures themselves are not 
recursive). Before the end of the define string is reached, this same 
process could happen again until either the maximum define nesting 


level is reached or the 100 character buffer is filled. 


The end of each define string(and the end of a record) is identified by 


a he 


When the scanner scans a yoy it will first check the define nesting 
level(DL). If DL is non zero, it will restore the scan pointer from 
the top of the DL stack and then resume scanning from there. Otherwise, 


it returns an end of record flag. 


MII. 
MACRO HANDL ING 


Non parametric MACROs: the macro records are scanned to eliminate 


unnessary blanks and then placed into a paged array. 


Parametric MACROs: the macro records are scanned, the formal parameter 
instances are replaced with an internal symbol identifying the macro 
number and parameter number, and the resulting record is put into a 


paged array. °* 


Parametric MACRO invocation: the internal formal parameters are generated 
ag defined tokens and the actual parameters are made define strings and 


associated with the internal formal parameter tokens. 


At the end of parametric macro invocation, the symbol table and define 
string paged array pointers are cut back to the state they were in 


before the parametric macro invocation. 


MIL COMPILER 
IF, SKIP OPTIMIZATION 


It is assumed that all instructions will generate the minimum amount 
of code in the first(compile) phase. 


Any instruction which is potentially a branch(IF, SKIP, GO TO and CALL) 
always has a label associated with it(exceptions: INC TEST, DEC TEST 


‘and BIAS TEST). The Label may be internally generated if it is not 


explicit in the source. 


Each such instruction has a parameter associated with it in the serial 


PARAM. FILE, Each label also has a parameter in the PARAM.FILE. 


The ‘PARAM, FILE is blocked by the compiler itself to guarantee that, 
for IF and SKIP, the label parameter and the reference parameter will 
always be available to the compiler for inspection and change if 


the statements can be optimized. 


if the compile phase knows for certain that an IF or a SKIP will 


generate exactly one or exactly two micro words, the parameters are 


' marked accordingly and optimization is complete for these statements. 


Otherwise, the optimization decision is left oe the fixup phase. 


Optimization attempts in the compile phase occur whenever a statement - 
referencing a previously deelared label is encountered or when a label 


which had forward references is declared. 


In an effort to complement the compile phase attempt at optimization, 
the fixup phase scans the PARAM.FILE in reverse. This approach does 
not guarantee complete optimization, but it does seem to cover the 


majority of cases, 
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Enclosed is an updated status report for software product specifications 
that are in the process of being revised or written, based upon information 
of September 30, 1975. The report has been revised to give a more accurate 
indication of the progress of each specification. The dates in the columns 
are explained below. 


Column 1. Gives the date by which the programmer should submit the 
. product spec. to the documentation group. 


Column 2, The date on which work actually began on formatting the 
document with DOCEDR. 


Column 3, The first rough draft was returned to the programmer for 
review and corrections. 


Column 4. The day the spec. was released by documentation for man- 
agerial review. 


Column 5. The date-:when the product spec. completed managerial re- 
view and was released to Records for distribution. 


The column headed TYPE will have several possible entries. The first entry 
gives the type of document (i.e., spec., manual, documentation). The ESTM 
entry gives the estimated dates for submittal to and completion by docu- 
mentation. CMPL shows the actual date on which each stage was completed. 


Any questions regarding scheduling or completion of a document should be 


directed to Jack Casey, Ext. 389. 


K. King 
Documentation 
Applications & Operations 
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PROD 2212 5421 A OELSAUDIT MAXWELL 
EST . T/9OLIT5 7/31/75 
CMPL 6/16/75 6/16/75 
eSTx 7/31/75 
CMPL 7/93/75 
PROD 2212 5439 A TEXT/EDITOR . LOGAN 
ESTM . 11/01/75 11/30/75 
PROD 2212 S447 A ILLUSTRATED MCS BATES 
ESTM 12/01/75 1/30/76 
PROD 2212 545% A DATACOM™’ SYS: BATES 
ESsTt 2/91/76 &/O1/7TE } 
PROJ 9000 000C A CANDE LOGAN DATES TSC 
Pee Sasa AP SYS sare 
PROD 2712 5462 A MOP TT EAUERLE CATES TRC 
PROD 1912 5681 A wMecP ft BAUERLE DATES TBD 
PROD 2212 54679 A OMS BAUERLE DATES TBD 
PROD 00099 0000 A I/9 DRIVER PAUESLE CATES TBC 
PROD 0000 9506 A MOP UTILITITS GB AUERLE CATES TeC 
---- ---- SFTIWR WAL cece 


PROD 2212 9698 8 CART THEPIAL IER LO/OLs75 VOL SCS PETERSEN 


TYPE 


PRICUCT 
SPEC 
NUMEER 


2212 S&9E 


22h (5151 


OC00 0005 


2212 5405 


2212 


5497 


5548 


REV 


rm 


A 


A 


A 


1403 Vo M INFERS 


$50) INT? ENV 


SGFTWARE PRODUCT SFECIFICATICH 


STATUS REPORT 


10/G2/75 PAGE 2 
PROOUCT SPEC DEV. ASSN. FIRST PROJ MENAGERS RESPONSIBLE COMMEATS 
TITLE DRAF DATE RCUGH REVIEW REVIEh PERSON 
PROS. DLOU. DRAFT 
CART DUMP 16/91/75 10/30/75 PETERSEN 
CASSETTE/SMAKER LO0/01/75 10/30/75 PETERSEN 
9/15/75 
IN“-PLACE SORT VAIL 
11/01775 11/30/75 
PROG LANGS <--- 
SOL S“LANGUAGE AUSTIN 
12/31/74 6/30/75 
12/30/74 5/01/75 
117 30¢75 
9/05/75 
SDL CBNF VERSTON) AUSTIN 
12/31/74 8/01/75 
12/30/74 3/91/75 
8/01/75 
S/OS/ 75 
RPG S“LANGUAGE RAPPAPORT 
L2/01775 1730776 
RPG COMPILER RAPPAPORT 
1o/s01/75 19/30/75 
MIL COMPILER: HAVERY CATES TBC 
CVBIL SwTLANGUAGE BERMAN RFESCKECULEC 
LOLO1/74 12/91/74 
9/11/74 8/15775 
11/30/75 
COBIL COMPILES pre BERMAN CATES TBC 
room EA tay wenn mane tte Nata caantan tesa A 
3501 yvoM IRFFRP RCEERTS AEh AT Set “* 
L/75 12791775 Bett Rate Sa ae 


— 
LAPMAN NERS ae 
Bes isle atlas Sete ass eercieeecernnet eet 
SoS OE 9 a Som RE OT yrereea toe 
ROBERTS NER AT 51) 


STAT 


TYPE 


PRODUCT 
SPE® 
NUMBER 


Rev 


PRODUCT 


TITLE 


SPEC 


SIFTRARE 


CEV. 
DRAFT 
PELs °° 


B4iDSST5 


9/27 775 


PREDUCY 
LNsO3/75 


ASSN. FIRST 
DATE ROUGH 
Necu.e DRAFT 


wo ON RE TR MRR HAM ROR ROR RAK FT TT OR EO RE HPN eR BM EE OMe OR OBE aZa eae BD BBS STB eens Benn anennaeaanaae 


9/15/75 


SPECIFICATICN 


PAGE 3 


PROJ 
REVIEX 


MANAGERS 
REVIE 


RESPONSIBLE 
PERSEN 


CC¥YFEATS 


PRON9 0000 0900 A 140) EYUL ENV PROG KERLEY NEW? 16TR7E 
PROD 2200 9849 EF 3850) ERUL FR-STNDG KERLEY CATES TRO 
PROD 2204 8680 C 1407 EMUL FR-STNOG KERLEY DATES TEC 
PRGD “9000 0000 A CREATE/8500 OISK KERLEY 

ESTM I/O01S75 10/91/75 

PROJ 0000 0000 A CREATE/VRTL 1311 KERLEY CATES TSC 


LL 


DOC 
cST4A 


0009 


000c 


00990 


A 


DOCUMENTS/MANUALS © 


NEWSLETTER CV.1) 
@1709 SYS INDEX 


RELEASE OOCMIN 


Yel RELEASE 


COMPLETED 


SPRES 


9/95/75 
2/95/75 


8/15/75 
BILSSTS 


901775 


2LISSTS 


LOsors7s 


10/95/75 
9/56/75 

10/93/75 

9/15/7775 
8/15/75 

IALSS IS 

Ss/15/75 


9/AS/TS 


3/30775 
I/I02/ 75 


19/30/75 


CASEY 


CASEY 


CASEY 


CASEY 


STAT TYPE 


PROOUCT 


sore 
Vroue 


NUMBER 


9849 
8680 
5982 
55 66 
5124 
S574 
5099 
5149 
5165 


9135 


REV 


BASIC 


SDL S-LANG 
COBIL S-LANG 
B300 EMUL FR-STNOG 
149) SERIES EMUL 
SPQ CART INIT 
DISK COPY 
FILS PUNCHER 
CART INLT 
DISK PACK INIT 
CASSETTE LOADER 
SSLOAD MAKCAS 
S~LANGUAGE 
DISK NUMP 
CASSETTE MAKER 
FILE LOADER 
CARTRIDGE /OUNP 
BASIC COMPILER 
DMP ALL 
NDL/LIBRARY. 
SRT 


LANG 


DISK SORT INTRIN 


BEAT OAM IP AL 


Catia 


RIELSTERMINAL (RIL) 


STFTWARE PRODUCT SPECIFICATIGN 
STATUS REPGRT 


9/1LLITS 
Q/1LITS 
9/11/74 
9/19/74 
O/1L/74 
Q/11LL74 
9/19774 
BS23/T4 
9/10/74 
I/1USTA 
9/10/74 
LL/27/7 4 
LP/0L/74 
9/1L/TL 
LOs30/74 
9/ID/74 
TO/OR/T4 
LU/STA/TA 
OF 50/74 


QLONST 


10/93/75 


9/24/74 
10/94/74 

9424/74 
LO/O4/74 

9/24/74 
10/08/74 
10/28/74 
10/15/74 
10/28/74 
10/23/74 
10/28/74 
12/03/74 
L2/12/74% 
LisO8/74 
11/27/74 
Le/ies7a 
Liseesin 
12728774 
Lesio/74 


L2/l6/74 


10/15/74 
1D/17/74 
IL Ss tA 


LOS17/74 


—LO/17/74 


11/06/74 


1i/06/74 


LL/O7/74 


Li/06/7% 


11/96/74 


1i/20/74 


12/05/74 


1/13/74 


W/14/75 


CF VOS7TS 


1/29775 


Les PRS TS 


12/28/74 


10/25/74 
10/25/74 
10/25/74 
10/25/74 
10/25/74 
1i/14/74 
LIs/14/74 
11/13/74 
Lis 18/74 
1i/1 8/745 
12/02/74 
12/13/74 
1/23/74 
12/25/74 
1/31/75 
2/03/75 
2427175 
V/LVLTS 
TALVISTS 


3/17/75 


MANAGERS 
REVIE 


3/27/72 
11/28/72 
1/Z2/73 
1/22/73 
10/28/74 
LO/ZE/S74 


10/28/74 


10/28/74 


10/28/74 


11/5774 


Li/iS/74 


Lisiss74 
11/15/74 
LL/15 774 
12/06/74 
12/16/74 
1/25/75 
1/30/75 
2/02/75 
2/11/75 
2428/75 
3/18/75 
T/L E/75 


3/18/75 


RESPONSIBLE 


PERSON 


AUSTIN 


BERMAN 


KERLEY 


KERLEY 


PETERSEN 


PETERSEN 


PETERSEN 


PETERSEN 


PETERSEN 


PETERSEN 


PETERSEN 


EEDGES 


PETERSEN 


PETERSEN 


PETERSEN 


PETERSEN 


KFECCES 


PETERSEN 


CGWLER 


CARCCONA 


VATL 


CEPENPAFL 


GCEFEL 


GOEBEL 


PACE 


CGMMERTS 


SCFEOCULEC 
SEFECULED 
SCFELDULED 


SCFECULEL 


FCR FEV. 
FOR REV. 
FCR REV. 


FCF FEV. 


4 


SUFTWASE PRECUCT SPECIFICATICN 
STATUS REPORT 


TG/903/75 PACE 2 
STAT TYPE PRODUCT REV PRODUCT SPEC CEY . ASSN. FIRST PROJ MANAGERS RESPCNSIBLE CO¥MERTS 
SPEC TITLE DRAFT DATE RCUGH REVIEW REVIE! PERSCN 
NUNBER PROS. CCcuU DRAFT 

PROD 2212 5199 A SYCSPY 2/14/75 3/20/75 3/24/75 4/03/75 4/04/75 PETERSEN 
PROD 2212 5207 A MERGE INTRINSIC L2/27/74 V/29/75 S/1 S77 BIZ IFTS G/04/75 WAIL 
PROD 2212 53589 A SOL/UPL COMPILER Les 3is7s& ef 23775 3/21/75 4/03775 4/07/75 AUSTIN 
PROD 2212 5371 A TRANS TA3LE GEN 3/24 475 &A/22/75 6/09/75 6/13/75 6/16/75 CEPENDAEL 
PROD 2212 5214 A COUBSL COMPILER 12/31/74 6/11/75 6/19/75 6/28/75 7/01/75 BERMAN 
PROD 2201 6737 A FORTRAN SwLANS. L2/SLIT5 6/07/75 6/19/75 7/25/75 6/04/75 JORE 
PROD 2212 5215 B NOL/SLIBRARY AS24775 | 6/06775 6/2C/75 g/05/75 Q/Ces75 DUPAR 
PRO) 2212 5322 A FORTRAN COMPILER L2/31/74 6/13/75. 6/19/75 8/06/75 8/11/75 JOBE 
PROD 2201 6737 8B FORTRAN S7LANG. 8/04/75 8/18/75 8/27/75 8/27/75 8/28/75 JGBE 
PROD 2212 5330 A EMUL LOADER TLUGSTS 7/23/75 B/22/75 $/902/75 S/E27 73 KRERULEY 
PROD 2212 5223 A NOL 5/16/75 8/07/75 B/11/75 9/08/75 SAOUSSES: “BATES 
PROD 2212 5231 B RJE/TERMINAL CSOL) B/ONLSTS B4i5775 9415775 Q/LSITS 9/22/75 MAXWELL 
PROD 2212 5749 8 RJSESTERMINAL CNDL) 8/01/75 R/15/75 9/15/75 9/19/75 9/22/75 MAXWELL 


STAT TYPE 


PROCUCT R 
SPEC 
NUMBER 


PRODUCT SPE 
TITLE 


cy 


SOFTWARE FROMLCT SPECIFICATICN 
STATUS REPORT 


MANAGERS 
REVIE’ 


RESPCNSTBLE 
PERSSON 


FACE E 
CCMMERTS 


PROD 


PRO) 


PROD 
MANE 


PROD 


PRC) 


PROD 


PROD 
PROD 
PROD 
PRO’ 
PROO 


PROD 


6729 
0009 


5256 


2201 2389 


2212 54095 


GUTIMGR'S APPROVAL 


B1700 RJE/OCH 


DCSAUDIT 


IN: DOCU OFFICE 


COBPL SLAAG 
SCNOPI/II 


B1i7Q0 HAS? 


IN: PROS CFFICE 


SOL S*LANGUAGE 


SOL C8NF VERSTON) 


IN? 197 3E SCHED 
CAEL COMPILER OGL 
MEPTI 

OMS 


BS O02 VOM TNTERP 
B50. INTP ENY PROS 


19/93/75 
CE. ASSN. FIRST PRGJ 
DRAFT DATE ROUGH ROVIEW 
PROC. Pec. CRAFT 
8/04/75 G/O04/75 
6/16/75 6/16/75 
G/OESTS 
9/352F75 
a/O38775 
9f/95775 
9fO5/7TS 


ERY AN 


CASEY 


KING 
BRYAN 


BRYAN 


KING 


CASEY 


KING 


CASEY 


ERYAN 


WEEKS. SEPT 28 = €cT 4 
FOR REVISICK 
FOR TRANS TG UC/LC 


FCR TRANS TE LESLC 


Burroughs Corporation INTER-OFFICE CORRESPONDENG! 
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___ Programming Activity 
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Factiee POS ROMmMInp. ACtIVAty. Persoune L260...) 26) tid te ees Petes & September 1975 mlson) 
ee oe 


We Michael] Denny ___Systems Technology 
SUBJECT: CE. 


CPM PERFORMANCE MONITOR 


As of September 8, 1975 five machines in the Software Development Machine 
Room are connected to the CPM Performance Monitor. These are: 


#384 (Closed Shop-B1726) 
#366 (MCP Development~B17 26) 
#377 (Language Development-B17 26) 


#308 (Data Comm-B17 26) 


#1186 Ceexayni7a4) S -Pr wsasery, — 2 0? 


The CPM cable connections to all these machines have been made to their 
respective backplanes and the cables are routed under the floor and out 
behind the CPM. Each group of cables is clearly labeled at the CPM end 
with the number of the respective machine and the proper socket into which 
each cable is plugged on the CPM. 


With this arrangement, it is possible to measure software on any of the above 
machines with only about five minutes' work connecting up the cables to the 
CPM. 


If anyone is interested in a class on how to wire the CPM plugboard, please 
contact Mike Denny. 


oF a ro oT ; 
fh LAL Zz 
7 


a 


W. Michael Denny 
Systems Technology 
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baeceed SE OOOR CE IMAGE. 23... 


ff ENVIRONSENT NAME “"G3ZO0OPS"EMLLATOR" 3 ¢ O00UuNT009 ; 
I Rite, atte, MEOR WC GR EES “SUB KE ci ced Oh ioc d Rak teed E ier te cesta te ttiad inact SAM ut Me Oe 0 O cant cnet aa eee des 
t CHRD, READER "CaRDS" 3 : 00003000 
: PRINTESY ACKURF DISK/TAPE ’ : 00004000 
22 Pee ee Se oamtedowtes - 120 POSITIONS. ’ Se Meyvesea t a. s 00005000 ehh 
: FORMS ’ : 00006000 
’ HARDWARE H 3s 00007000 
Jeet ee Pe eR NT ER Os ew UO DESK: on os gu ee es be te i 000080 00sec See he 
3 132 POSITIONS , , 2: 00009000 
: PUPCH j s 00010000 
F whe cent OO. goes WORE Ves OA Gre, ot, Appel ets tients ie Lio i : 00611000 
t CARTRIDGE : ’ . t 00012000 
H NEw 3 : 00013000 
st eo Me wae Mer ble tenet ted I ta Ee oe le oan Sp rece ee ote aes ee tak eet el lB AO OO wees) pak! ead, a 
3 OLD ’ t 00015000 
H OACK } : 00016000 
hide TBS __... Sue "OISK™/S"FILE" 2 Dispel See yp dd halle . 7 s 00017000 
3 FILE ’ : 00018000 
H NEw ’ # 00019000 
sdiKehiyatrata Socesecue tise Deni! Sy ache ca Ce Vg Al ascot ee TON gia Cte Ps bel ete a ol ee ce catalan «Gs UNE OU UO i Ce Ane hee we. 
z $43 NBACKUS™FAMNIL YM ZU NAME! } : 00021000 
$ Sud Aan H : 00022000 
Bind See 44 axes 9US ga > a : 00023000 
: Sus a Oa i s: 00024000 
H SUT "ec" H ¢ 00025000 
ed Finis ce hot Ge aN et OU cats net Shika, eth eh alee AY) Se Renee IRIs ROIS AERA REPO -$ 06026000 = ¢ 
H " §y9 } : 00027000 
: Tare, ATA ’ : 00028000 
aohab Pesan e PARITY OOD ’ oe s 00029000 
$ TAPE ; : 00030000 
t TAPEQ MTB ’ : 00031000 a 
fag Pt Ain Se oe cscs TAPE,7.. aus Dey Sere re re ee ee Te : : 00032000 7 : €) 
H PARITY EVEN } : 00033000 ah’ 
: TAPES MTC ; : 00034000 
_ rt TAPE,9 1 $ 60035000 
H TAPEY MTO } : 00056000 
3 TAFES MTE 3 : 00037000 
5 Seance Bale he tm tl ga he On aan ee SIE ce pn 8 mee eh ns ate en gt oth ict at tee g Sen s 00038000 st 
: TEACE GFF r : 00039000 
H ENASLE,TERMINATE.PSEUDO 3 s 00040000 . 
7 ee _ END seer 2 _ ie s 00041000 
oe eee END 6300 EMULATOR ENVIRONMENT CCEPSJON  — ph cheatocetet on Laat, ieedea so cn eee fess bet ee tersceeds tse —— 
SC ESRORS Ih ENVIQGONMENT SPECIFICATION 
5306 JE”*UL ATOR SUCESSFULLY CCERCED 
ESVIRONFENT CHAKACTERISTICS?3 
CORE REGUIRED TO RUN: 0179995 BITS 
Sth chee ale Bernd VE tee nd Pod Digs: 2, athe ree eo te TU ek Ae Ete ate San that See Me a CS A a ena ee Oe att et OA 
CLG, KE ADER 
PRINTERL 
nee _.... PRINTER? eae . Fee * 3 Be - 7 
PUNCH : 
; $40 . 
-. $d). . Sates: = : é 3 x 5 ae 
bia Ne Slee ae nica mee acct ate Lf ge BAN hee ta crime cae Ah ane eat a IRE San tk ene Ne ene Lea hho nee ee ONC ha Oh ia Ee fe ten at on as be Eh ates et tt 
$u3 7 
Sua 
$us 
$6 
hae i ho a en OTe te ID a a tn es ae ict A Ie are Dt a eA a ols ee, Ate, ata Ok AN a oat anes 
Sua 
$u9 
Z Me he Ge eet TAPED Scone ee ees ea nee So coe _ 
TAPE2 Cc } 
TAPES ok 
Do i ee oa ty hoes nt gut PIN caters cael oakland iced cae ain eA es haa eee ome etna at autiens auton We § anak 
TAPES 
TAPES 
OTRER CHARACTERISTICS! 7 
TERMINATE, FP SEUG9 ENABLED 
TAPE SUFFER, SIZE = OL15e200 SITSCMEF AULT) 


Buse GuS9S nl 700. 6 G300 EMULATOR ENVIRONMENT PROGRAM, MARK. V,0 (06/09/75 22:44). TUESDAY. D6/24/75, Ley: 
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LOCATION _ 
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DA TE 
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_. Computer Systems Group | Santa Barbara Plant 


Language Development. | a 


SUBIEC TT. c.c. 


SYSTEM/PATCH 


Today IL am releasing a version of SYSTEM/PATCH with the following changes: 
1. The maximum number of patch cards is increased from 4086 to 16374. 


2. A new option S#PAGEP is added. This.causes each patch to begin 
on a new page in the LISTP listing. 


3. Anew option S#END is added. This serves as an end of file for 
SYSTEM/PATCH so that extra cards stored behind it are ignored. 


4, The sequence field is blanked out on $? cards (pseudo control cards). 

5. When generating a new symbolic, SLIST no longer has an effect. To 
get a Listing of the new symbolic, the option S# LISTNEW (alias 
LIST.NEW) has been added. 


I encourage use of the pseudo deck mode of operation for SYSTEM/PATCH, 
especially for closed shop jobs. 


B. Dodson 
Competitive Languages Section 
Language Development 
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I. 


Il. 


Ili. 


* 


pp wd an CwusdC2. 


No Tée MiwArs [daclica lee! <, SCime 


Closed ship hurnaronel 


Weaknesses of Current System 


A. Not enough jobs. 
B. Too many jobs. 
Cc. No one responsible for efficient operation. 
D. Bypassing or ignoring queue. 
E. Sign up just in case, then not ready. 
F. Printer tied up too long. lA-xX EoF CPA 
u re) 
G. Card Reader tied up too long. CRA oo LD 
H. Over running scheduled time 
Goals 
A. Keep system running efficiently at all times, using controlled 
multiprogramming. 
B. Be able to run small jobs without queue sign up or long wait. 
“CC. Be able to leave simple jobs to be run during available time. 
D. Minimize stand alone (non-multiprogramming) time but allow 
for it when necessary. 
E. Allow for using text editors. 
F. Improve closed shop turnaround. 


Proposed System 


A. 


Divide day into equivalent 30 minute sign up periods. Multi- 
program during all these periods with minimal exceptions. 


Maintain a queue of work to be done. Ideally and after this 
will consist of persons waiting with short jobs but will 
overflow into written queue. 


Sign up for a period inplics: 

1. Commitment to be at machine during entire period. 

Ze FLYSt: preority. 

3. Responsibility for efficient operation of machine. This 


includes calling next person in queue and resolving problems 
and conflicts. 


oe 


4, Ensuring integrity of quecuc. 


: a eo. . 
Bea SS we 7 ges 
Me te dk gb 


Ili. Proposed System (Continued) 
D. If a queue develops the following apply: 


1. If next person is not at posted phone number, bypass but 
leave at top of queue. 


2. If next person is not ready, move to bottom of queue. 
3. Person calling scratches name of person contacted. 
FE. Provide for simple jobs to be run in absentia with following: 
1. No action required except putting dech trhough reader. 
2. Deck set up to force output to backup. 
3. Backup files not removed except at 8:00 and 12:00. 
4. SPO printout not removed from machine. 
F, To avoid tying up peripherals, use the following: 


1. Modify SDL and MIL to send output to backup. (Keep standard 
file cards on machine to override.) 


2. Use SYSTEM/PATCH or Load control to avoid tying up readers. 
3. Minimize listings. 
G. To avoid overloading machine, do all create masters, long compiles, 
: full listings, xrefs, etc. in closed shop. Submit formal 
complaint any time held up by closed shop turnaround. 
H. To improve multiprogramming efficiency, observe following: 


1. Modify SDL to use 50,000 bits dynamic. 


2. Avoid running two processor bound jobs together. This applies 
especially to SDL and MIL compiles. 


3. Run long jobs at lower priority. This gets short jobs out 
of the way resulting in best efficiency. 


I. Indicate the nature of work for all queve entries using the 
following classifications: 


1. I/O (LOAD/DUMP, DMPALL, listing, punching cards, etc.) 
2. Small jobs 

3. Recomp 

+e MIL compile 


hd 


5. Text Editor (Gordon Browne's) 


III. 


Proposed System (Continued) 


I. 


(Continued) 

6, CANDE 

7. Stand alone 

If machine is preempted for emergency, schedule slides. 
Preemption is responsible for reporting new times to all 


persons signed up. 


Anyone switching to non-standard software is responsible for 
switching back before leaving. 


Full compiles of compilers allowed if nothing else to run. 
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FILE NAMING CONVENTIONS — LANGUAGE DEVELOPMENT Language Development Dept. 


DEPARTMENT 


Software Activity Managers 
E. Munsch 


Starting with the Mark 6.0 release, the file names from this department 
will conform to the following conventions with respect to SOURCE files 


and BACKUP files: 
Valid family names 


SOURCE 

BACKUP. PRT 
BACKUP. XRF 
BACKUP. XMP 


Source 
Backup-listing 
Backup-—XREF 
Backup-XMAP 


Project names will be abbreviated as follows: 


BAS 
B500 
COB 
FOR 
MIL 
RPG 
SDL 
UPL 
1400 


Source file names will be: 


SOURCE/ Project 


e.g. SOURCE/FOR 


PRINTED IN U.S. AMERICA 


(BASIC) 
(B500) 
(COBOL) 
(FORTRAN ) 
(MIL) 
(RPG) 
(SDL) 
(UPL) 
(1400) 


Empty for compilers 
IT - for intrinsics; up to 4 characters 
. may follow 
IN - interpreters; up to 4 characters 
may follow 
LB —- Libraries; up to 4 characters 
may follow 
Escape - for programs not fitting into 
scheme above 


(FORTRAN compiler) 


Freacfemlinp 


} 


FORM 47°R EDV. 4° 67) 
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Backup files will bes: BACKUP. PRT /Project (**) 
XRF 
XMP 


(*«*The diagram below follows project) 


Empty 
IT - intrinsics; up to 4 characters may follow 
é-------------------- FOR INTERPRETERS ----------------- > 
TRACE COMPILER | HARDWARE 
DESIGNATION LEVEL i he Gi aa LEVEL | LEVEL {| SEGMENT 


T i S 


N 


Escape 


Here “TRACE DESIGNATION" denotes whether the interpreter is a trace inter- 
preter; ''COMPILER LEVEL", "GISMO LEVEL", and "MCP LEVEL" give the level 
designations for the aapespriate pieces of software; "HARDWARE TYPE" denotes: 


S - 1710 machine, 

M - 1720 machine, 

U - Universal to run an all 1700s, 
E - Entry level machine; 


and "EXTERNAL SEGMENTS" describes whether the interpreter is segmented, (X), 
or not, (N). 
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The following files are currently contemplated as part of each MARK release. 


BASIC 
Source Backup 
SOURCE/BAS (BASIC Compiler) BACKUP. XRF/BAS 
BACKUP. PRT/BAS 
SOURCE/BASIN (BASIC Interpreter) BACKUP. PRT/BAST1U31N 
(BASIC Interpreter)} BACKUP. PRT/BASN1S31X 
BACKUP. PRT/BASN1M31X 
BACKUP. XRF/BAST1LU31N 
BACKUP. XRF/BASN1S31X 
BACKUP. XRF/BASN1M31X 
SOURCE/BASITCAT BACKUP. PRT/BASITCAT 
SOURCE /BASLTCON BACKUP. PRT /BASITCON 
SOURCE /BASITDCT | BACKUP. PRT/BASITDCT 
SOURCE /BASITEOJ . BACKUP. PRT /BASITEOJ 
SOURCE/BASITERR BACKUP. PRT/BASITERR 
SOURCE /BASITEVI BACKUP. PRT/BASITEVI 
SOURCE /BASITEXP BACKUP. PRT/BASITEXP 
SOURCE /BASITFAP BACKUP. PRT/BASITFAP 
SOURCE/BASITFBS BACKUP. PRT/BASITFBS 
SOURCE /BASITFDE BACKUP. PRT/BASITFDE 
SOURCE/BASILTFEM . BACKUP. PRT /BASLTFEM 
SOURCE /BASITFMA _ BACKUP. PRT/BASITIMA 
SOURCE/BASITFRE BACKUP. PRT/BASITFRE 
SOURCE/BASITFSC BACKUP. PRT/BASITFSC 
SOURCE/BASITFUN BACKUP. PRT/BASITFUN 
SOURCE/BASITIDN BACKUP. PRT/BASITIDN 
SOURCE/BASITINT BACKUP. PRT/BASITINT 
SOURCE /BASLITINV BACKUP. PRT /BASLTINV 
SOURCE /BASITIOB BACKUP. PRT/BASLTIOB 
SOURCE /BASITLOG BACKUP. PRT /BASITLOG 
SOURCE /BASITFMT BACKUP. PRT /BASLTFMT 
SOURCE /BASITFOC BACKUP. PRT /BASITFOC 
SOURCE /BASITMAD BACKUP. PRT /BASITMAD 
SOURCE /BASITMAS BACKUP. PRT /BASITMAS 
SOURCE /BASLTMMY BACKUP. PRT /BASITMMY 
SOURCE /BASLTMOD BACKUP. PRT /BASLTMOD 
SOURCE /BASITMRI BACKUP. PRT /BASITMRI 
SOURCE /BASLTMSB BACKUP. PRT /BASITMSB 
SOURCE /BASLTMSM : BACKUP. PRT /BASLTMSM 
SOURCE /BASLITNUL BACKUP. PRT /BASITNUL 
SOURCE /BASITPRM BACKUP. PRT /BASLTPRM 


-SOURCE/BASITPWR BACKUP. PRT /BASITPWR 
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Source 


SOURCE /BASITREP 
SOURCE /BASITRIA 
SOURCE /BASITRND 
SOURCE /BASITRNI 
SOURCE /BASITSCN 
SOURCE /BASITSGN 
SOURCE /BASITSOR 
SOURCE /BASITSTR 
SOURCE /BASITTRG 
SOURCE /BASITTRM 
SOURCE /BASITTRN 
SOURCE /BASITVAL 
SOURCE /BASITZER 
SOURCE /BASITPRT 


BASIC - Continued 


Backup 


BACKUP, PRT /BASITREP 
BACKUP, PRT/BASITRIA 
BACKUP. PRT/BASITRND 
BACKUP, PRT /BASITRNI 
BACKUP. PRT /BASITSCN 
BACKUP. PRT /BASITSGN 
BACKUP, PRT /BASITSQR 
BACKUP, PRT /BASITSTR 
BACKUP, PRT/BASITTRG 
BACKUP. PRT /BASITTRM 
BACKUP. PRT /BASITTRN 
BACKUP. PRT /BASITVAL 
BACKUP, PRT /BASITZER 
BACKUP, PRT /BASITPRT 


Distribution 
December 17, 1975 
Page 5 


source 


SOURCE/B500IN 


B500 


SOURCE/B500IEP (Interpreter environment program) 


Source 


SOURCE/COB (COBOL Compiler) 
SOURCE/COBLB (COBOL Library) 


SOURCE/COBIN 


COBOL 


(COBOL Intrepreters) 


(COBOL Micr Interpreters) 


Backup 


BACKUP. PRT /B5001LEP 
BACKUP. XRF/B5001EP 
BACKUP, PRT/B500T1U31X 
BACKUP. XRF/B500T1U31X 
BACKUP. PRT/B500T1U31N 
BACKUP. XRF/B500T1U31N 


Backup 


BACKUP, PRT/COB 


BACKUP, PRT/COBN1S31X 
BACKUP, PRT/COBN1M31X 
BACKUP, PRT/COBT1LU31N 


BACKUP. XRF/COBN1S31X 
BACKUP, XRF/COBN1S31X 
BACKUP. XRF/COBN1U31X 
BACKUP, PRT/COBMICRI1S 
BACKUP, PRT/COBMICR1M 
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Source Backup 
SOURCE/FOR (FORTRAN Compiler) | BACKUP.PRT/FOR (FORTRAN Compiler) 
SOURCE/FORIT (FORTRAN Intrinsic source) BACKUP.PRT/FORIT (Intrinsic Listing) 
SOURCE/FORITMAK (Intrinsic Maker) BACKUP. PRT/FORITMAK (Intrinsic Maker) 
SOURCE/FORIN (Interpreter Source) BACKUP. PRT/FORT1U31N (FORTRAN Interpreter) 

BACKUP. PRT/FORN1S31X 

: BACKUP. PRT /FORN1M31X 

BACKUP. XRF/FORT1U31N 

BACKUP. XRF/FORN1S31X 

BACKUP. XRF/FORN1M31X 

MIL 

Source Backup 


SOURCE/MIL BACKUP, PRT/MIL 
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Source 
SOURCE/RPG (RPG Compiler) 


SOURCE/RPGIN (RPG Interpreters) 


SOURCE/RPGBTF (Build tag file 
for IS updates) 
SOURCE/RPGREORD 


Source 


SOURCE/SDLUPL (SDL/UPL Source) 


SOURCE/SDLIN (SDL Interpreter) 


RPG 


SDL/UPL 


Backup 


BACKUP.PRT/RPG (RPG Compiler) 

BACKUP. PRT/RPGT1U31N (RPG Interpreters) 
BACKUP. PRT/RPGN1S31X 

BACKUP. PRT/RPGN1M31X 

BACKUP. XRF/RPGT1LU31N 
BACKUP.XRF/RPGNI1S 31X 

BACKUP. XRF/RPGN1M31X 

BACKUP. PRT/RPGBTF 


BACKUP, PRT/RPGREORD 


Backup 


BACKUP.PRT/SDL (SDL) 
BACKUP, PRT/UPL (UPL) 


BACKUP. PRT/ITOO 
BACKUP. PRT/ITO1 (Intrinsics) 
BACKUP. PRT/ LT02 
BACKUP. PRT/ L[T03 
BACKUP. PRT/ LT04 
BACKUP. PRT/ IT05 
BACKUP, PRT/ IT06 
BACKUP. PRT/ IT07 
BACKUP. PRT/ LT08 
BACKUP. PRT/ ITO9 
BACKUP, PRT/ IT10 
BACKUP, PRT/IT11 
BACKUP. PRT/ L[T12 
BACKUP. PRT/ IT13 
BACKUP. PRT/ IT14 
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Source 


Source 


SOURCE/1400IV 
SOURCE/1400 IEP 


1400 


SDL/UPL - Continued 


Backup 


BACKUP. PRT/SDLUPLXRF (XREF PGM) 
BACKUP, PRT/SDLUPLXMP (XMAP PGM) 
BACKUP. PRT/SDLT1U31N (Interpreters) 
BACKUP. PRT/SDLN1U31X 


‘BACKUP. PRT/SDLN1M31X 


BACKUP. PRT/SDLN1U31N 
BACKUP, PRT/SDLN1E31X 
BACKUP. PRT/SDLIN.MCPI (MCPI Special Interp.) 
BACKUP. PRT/SDLTC.MCPI 


Backup 


BACKUP. PRT/1400IEP 
BACKUP. XRF/1400I1EP 
BACKUP, PRT/1400T1U31X 
BACKUP, PRT/1400T1U31N 
BACKUP, XRF/1400T1U31X 
BACKUP .XRF/1400T1U31N 


It should be noted that separate BACKUP.XRF listings for each interpreter 
might disappear at such time that MIL includes XREF listings with the out- 


put print file. 


F, Alan Goodman, Managér 
Language Development 


jg 


From Burroughs Program Products Library 


IBM 1401,1440, 1460 
Free Standing Emulator 
on the B1720 


114 


Creates IBM 1401, 1440, 1460 Environment 


STYLE NUMBER 


CS 1720 114 


CAPABILITY 


The IBM 1401, 1440, 1460 Emulator sim- 
plifies the transition between the IBM 1401, 
1440, 1460 and Burroughs Small Systems. 
The Emulator creates an IBM 1401, 1440, 
1460 environment within the B 1720 mem- 
ory. This permits the direct execution of 
1401, 1440, 1460 object programs. 


Emulation of IBM 1401, 1440, 1460 pro- 
grams provides an excellent interim conver- 
sion solution until these programs can be 
redesigned to take full advantage of the 
advanced architecture of Burroughs B 1720 
Systems. This capability allows emulation 
without incurring a peak workload and with- 
out duplicate machine costs normally associ- 
ated with conversion. 


The IBM 1401, 1440, 1460 Emulator sup- 
ports most 1401, 1440, 1460 functions and 
all standard peripheral input/output devices 
except MICR, data communications and 
paper tape devices. Additionally, programs 
specifically written for 4 K 1401, 1440, 1460 
systems that are dependent on Address Reg- 
ister settings after execution, may -not be 
emulated correctly. 


GENERAL FEATURES 


e Provides the same operating environment as 
defined for the IBM 1401, 1440, 1460 
object program. 


e Maintains the arithmetic, logical and data 
movement logic of the original system. 
Accommodates indexing. 

Accommodates sense switches. 
Accommodates process overlap feature. 
Accommodates disk emulation. 
Accommodates emulation of 4 K, 8 K, 12 
K, or 16 K character core memory systems. 


Emulated Instructions 
General 


The following instructions are executed by 
the IBM 1401, 1440, 1460 Emulator: 


Input/Output 
Arithmetic 
Logic 

Move and Load 
Magnetic Tape 
Disk 

Console Printer 
Miscellaneous 


Input/Output 


The following Input/Output instructions are 
emulated: - 


Read Card (and Branch) — R 

Write Line (and Branch) — W 

Write Word Marks (and Branch) — WM 
Write and Read (and Branch) — WR 
Punch Card (and Branch) — P 

Read and Punch (and Branch) — RP 
‘Write and Punch (and Branch) — WP 
Write, Read and Punch (and Branch) — 
WRP 

Start Read Feed (same as NOP) — SRF 
Start Punch Feed (same as NOP) — SPF 


@ Write Disk Track Sectors with Addresses 
and Word Marks — WDTW 

e Write Disk Sectors with Word Marks — 
WDW 


Console Printer 


A maximum of 60 characters is allowed 
during a Console Printer Read instruction. 
The IBM 1401, 1440, 1460 Emulator emu- 
lates the following Console Printer instruc- 
tions: 


Miscellaneous 


The following Miscellaneous instructions are 
emulated: 


From Burroughs Program Products Library 


Compare — C 

Control Carriage on Printer — CC 
Clear Storage (and Branch) — CS 
Clear Word Mark — CW 

Halt (and Branch) — H 

Modify Address — MA 

No Operation — NOP 


Store A-Address Register — SAR 
Store B-Address Register — SBR 
Overlap On, Off, Reset (and Branch) 
(same as NOP) — SS 

Select Stacker Pocket (and Branch ) — SS. 
Punch stacker number four goes to aux- 
iliary; otherwise — NOP 
e Set Word Mark — SW 


e Read Console — MU-R 
e Write Console — MU-W 
e Read Console with Word Marks — LU-R 
e Write Console with Word Marks — LU-W 


PRODUCT IDENTIFICATION 


Support 
Program ID Description Media Category 
EM1400 IBM 1401, 1440, 1460 Emulator Object Code A* 


SYSTEM REQUIREMENTS 


Central B 1720 central processor 
Processor : with console printer 
Memory: 4 KB M-memory and 48 KB 


of Main Memory 


Similar |/O devices to 
execute IBM 1401, 1440, 
1460 program requirements 


Peripherals: 


Disk: At least one disk subsystem 


* Support Category A indicates a ‘‘Supported Licensed Program” as defined in the Program 
[ Products License. : 


From Burroughs Program Products Library 


Arithmetic 


The IBM 1401, 1440, 1460 Emulator emu- 
lates the following Arithmetic instructions: 


e Add—A 

e Subtract —S 

@ Zero and Add — ZA 

e@ Zero and Subtract — ZS 


e Multiply —M 

e Divide — D 

Logic 

e Branch Unconditional — B 

e Branch If Equal Compare — BE 

e Branch If High Compare — BH 

e Branch If Low Compare — BL 

e Branch If Unequal Compare — BU 

e Branch If Arithmetic Overflow — BAV 

e Branch If Carriage Channel No. 9 (same as 


NOP) — BC9 

Branch If Carriage Channel No. 12 — BCV 
Branch If Character Unequal — BCE 
Branch Bit Equal — BBE 

Branch If End of Reel — BEF 

Branch If Tape Error — BER 

Branch on I/O Check Stops or Busy (same 
as NOP) — BIN 


e Branch after Console Write — BIN-O 

e Branch If Last Card Switch On — BLC 

e Branch If Sense Switch B (C-G) On — BSS 

e Branch on Word Mark and/or Zone 
Condition — BWZ 

e Branch If Access Inoperable (same as NOP) 


— BIN 

e Branch If Wrong Length Record — BIN 

e Branch If Unequal — Address Compare — 
BIN 

e Branch If Any Disk Condition — BIN 

e Branch If Disk Access Busy — BIN 


Move and Load 


The IBM 1401, 1440, 1460 Emulator emu- 
lates the following Move and Load instruc- 
tions: 


e Load Characters to a Wore Mark — LCA 
e Move Numeric — MN 


e Move Zone — MZ 

e@ Move Characters and Edit — MCE 

e Move Characters to Record Mark or Group- 
Mark Word Mark — MCM 

e Move Characters and Suppress Zeros — 
MCS 

e@ Move Characters to A or B Word Mark — 
MCW 


Magnetic Tape 


The following Magnetic Tape instructions (for 
both 7-track and 9-track tape) are emulated: 


Back Space Tape Record — BSP 
Read/Write Tape in Overlap — MU 
Read Tape — RT 

Read Tape with Word Marks — RTW 
Rewind Tape — RWD 

Rewind Tape and Unload — RWU 
Skip and Blank Tape — SKP 

Write Tape — WT 

Write Tape with Word Marks — WTW 
Write Tape Mark — WTM 

Diagnostic Read — CU 


Disk 
The following Disk instructions are emulated: 


e Read Disk Sectors — RD 

e Read Disk with Sector Count Overlay — 
RDCO 

e Read Disk with Sector Count Overlay with 
Word Marks — RDCOW 

e Read Disk Track Sectors with Addresses — 
RDT 

e Read Disk Track Sectors with Addresses 

and Word Marks — RDTW 

Read Disk Sector with Word Marks — RDW 

Seek Disk — SD 

Write Disk Sectors — WD 

Write Disk Check — WDC 

Write Disk with Sector Count Overlay — 

WDCO . 

e Write Disk with Sector Count Overlay wit | 
Word Marks — WDCOW 

e Write Disk Check with Word Marks - 
WDCW 

e Write Disk Track Sectors wit’ “ddress . 
WDTA 


From Burroughs Program Products Library 


=; Burroughs 


1068210 8 6/73 Printed in U.S. America 


os RELGEN Users 


FROM: Bill Firestone 


Attached is updated information on RELGEN and a description of a 
related program, RELGEN/MASTER. The most important change is the 
choice of entering RELGEN parameters either from cards, as in pre- 


vious versions, or from the SPO. 
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REtGeEN 
RELEASE TAPE GENERATOR: 


VERSION 1.6 


RELGEN IS A UTILITY PROGRAM USED TO READ AND REPRODUCE 


INFORMATION ON A *RELEASE™ TAPE. THE TNFORMATION TS ASSUMFD 


TO BE ON A RELEASE TAPE GENERATED BY THE MIL COMPILER OR 
A MASTER RELEASE TAPE AS OUTPUT BY RELGEN/MASTF™. TO 


REPRODUCE INFORMATION ON THE TAPE» PARAMETER CARDS ARE TNPUT 


TO THE PROGRAM. VALID PARAMETERS AND THEIR MEANINGS ARF: 


LISTCLI) “<== GENERATE A LISTING TO THE PRINTER 

PUNCHCPU) =<"= PUNCH THE NBJECT CNDE 

COPY(CO) s<--- COPY THE RELEASE TAPE TO A NEW TAPE 

SOURCE(SO) ===. COPY SOURCE FILE Tn DISK FILE "SOURCF" 

OBJECTC(O8) =-= COPY THE CODE FILE TO DISK FILE "CONE" 

MASTERCMA) === THE INPUT TAPE IS A MASTER RELEASE TAPF 
CIF USFD» THIS MUST BE ON THE FIRST 
CARD AND MUST BE THE FIRST PARAMETER 
ON THE CARD) © 

MGOPYCMC) ="== COPY AN ENTIRE MASTER RELEASE TAPE Tf A 
NEW TAPE 

FILECFI) <FILE.NAME> === FOR A MASTER RELEASE TAPE> 
ALL SUBSEQUENT REFERENCES ARE TO FTLE 
<FILE.«NAME> 


PARAMETERS MAY BE ENTERED EITHER FROM CARDS OR FROM THE 
SPO. RELGEN ASSUMES SPO INPUT UNLESS THE USER INCLUDES 
A FILE STATEMENT? : 


?FILE SPEC NAME = «<ANY.FILE.«NAME> 


AT EXECUTION TIME IN WHICH CASE INPUT .1TS FROM A CARD FILE 
CALLED <ANY.FILE.NAME>,. IF INPUT TS FROM THE SPO» THE 
PROGRAM GOES TO EQJ WHEN A BLANK LINE TS ENTERED FROM THE 
SPO: 


&MIX«NODAX 
FOR EXAMPLE» THE DECK 


@EX RELGEN FILE SPEC NAME CARDS 
2DATA CARDS | 7 
COPY LIST PUNCH 
PEND ; 
i 

WOULD COPY THE RELEASE TAPE TO A NEW TAPE AND CAUSE BOTH 
A SOURCE LISTING AND OBJECT DECK TO BE PRONUCEN. IF 
MULTIPLE COPIES OF INFORMATION ON A RELEASE TAPE ARF 
DESIRED» A NEW PARAMETER CARD MUST BE USED FOR EACH ONE. 
FOR EXAMPLE» THE DECK | 
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* * 
* ?EX RELGEN FI SPEC NAME CARDS * 
* 2DATA CARDS * 
* LIST™ * 
* PUNCH LIST * 
* ?END * 
r * 
* WOULD PRODUCE TwO SEPARATE LISTINGS AND ONE PUNCHED OBGIFCT * 
* DICK. IF A TAPE CONTAINS A MASTER RELEASE TAPE CAS OUTPUT * 
* BY RELGEN/MASTER) THE FOLLOWING WOULD PRODUCE LISTINGS OF * 
* FILES "COBOL/INTERP*® AND "SDL**3 * 
* 8 * 
* ? EX RELGEN FI SPEC NAME SPEC * 
* 2DATA SPEC * 
* MASTER FILE COBOL/INTERP LIST * 
* FILE SDL LIST * 
ok PEND * 
* * 
* THE FOLLOWING FILES ARE USED BY RELGENS * 
* SPEC =<" = PARAMETER CARD INPUT ONLY IF GIVEN IN AN * 
* MCP FILE STATEMENTS ELSE TNPUT IS FROM * 
* THE. Seo * 
* TAPE s=*="" RELEASE TAPE FROM MIL OR RELGEN/MASTER * 
* NEWTAPE == TAPE GENERATED BY: RELGEN x 
x PRINTER "= LISTINGS GENERATED RY RELGEN * 
* PUNCH es=<s PUNCHED ORVJECT DECK GFNERATED RY RELGEN * 
* CODE se"™="= ORJECT CODE DISK FILE CREATED BY RFLGFN * 
* SQURCE =="*= SOURCE CODE DISK FILE CREATED BY RFLGEN ke 
* * 
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RELGEN/ MASTER 


VERSION 1.9. 


RELGEN/MASTER [IS USED TO CREATE A MASTER RELEASE TAPE FROM 
ONE OR MORE CA MAXIMUM GF 16) RELEASE TAPES AS PRODUCED BY 
MIL. THE PROGRAM READS CARDS FROM FILE "CARDS", RELEASE 
TAPES FROM "RELEASE" AND WRITES A MASTER RELEASE TAPE TN A 
TAPE FILE WITH MULTIFILE,.IO = "RELEASE." INPUT OW FILE 
CARDS CONTAINS INFORMATION ASOUT THE TAPES iJ BE READ. 
INFORMATION IS PROVIODEDs ONE 80 COLUMN CARD PER RELEASE 
TAPE. EACH CARD HAS THREE KEYWORD PARAMETERS» ALL REQUIRED. 
THEY MAY APFEAR IN ANY ORDER» SEPARATED BY ONE COMMA AND/OR 
ONE OR MORE BLANKS.» EACH KEYWORD [5 SEPARATED FROM ITS 
VALUE BY AN EQUAL SIGN AND/OR ORE OR MORE BLANKS. THE THREE 
KEYWORDS ARES 


NAME = <FILE-IDENTIFIER> CWHERE <FILE.~IDENTIFIER> MAY 
INCLUE A <FILE.~TD> OR A <MULTI.FILE.10> / 
<FILE.ID>) 

REL.~LEVEL = <4 CHARACTER RELEASE LEVEL> 

PRQG.LEVEL = <4 CHARACTER PROGRAM LEVEL> 

THE INFORNATION CONTAINED ON THE CARDS IS MAINTAINED IN A 
DIRECTORY AS THE FIPST FItt OF THE MASTER RELEASe TAPE. 


AFTER READING ALL OF THE CARDS+ THE PROGRAM WILL ISSUE SPO 
MESSAGES REQUESTING THE OPERATOR TO PROVIDE EACH OF THE 
RELEASE TAPE SPECIFIED ON THE CARDS. 


EXAMPLE 
?P?EX RELGEN/MASTER 


2DATA CARDS 
NAME = CPBOL/SINTERP314 RELA~ALEVEL=0331/PROG.LEVEL=0401 


REL~LEVEL= 0330> PROG.LEVEL =1709 » NAME SDL/INTERP 


i a ee ef 


2END 
FILES USED BY RELGEN/ MASTER 
CARDS wwrr FILE INFORMATION INPUT TO RELGEN/MASTER 
LAPE Sees FILE FROM WHICH INDIVIDUAL RELEASE TAPES ARE 
READ * 
RELEASE =~ WILL CONTAIN THE GENERATED MASTER RELEASE TAPE® 
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% RELEAS 
DATA. Canes 
é ?7CO YorPrRros | 
MIL 
COMPILER 


~o— PUNCH] 
7DATA CARRS 
(EX RELGREN 


> 
: DECK 


RELGEN 


SOURCE 


Se 


SOV RCE 


7 DATR CAROS 
7EX RGEW/mastet 


MASTETL 
REeLease 
TAPE 


RELERS REL cAS 

TAPE Tees: 
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DISK CARTRIDGE INITIALIZER 


GENERAL 


The DISK CARTRIDGE INITIALIZER must be used to initialize a disk cartridge 
before it can be used for the system software. The initializer assigns 
addresses to the appropriate segments:and writes a random pattern in the 
segments to ensure the segment is not defective. When a segment is found to 
be bad the entire track in which it resides will be removed from the disk 
available table on that disk cartridge. If a segment is found to be bad 
within the first 64 segments of a disk cartridge, that cartridge cannot be 


used due to the system requirements, 


OPERATION INSTRUCTIONS 


The disk initializer program does not operate under the control of the MCP 
and must be loaded and executed through the cassette reader on the control 


panel. 


Information will be supplied to the initializer through the SPO as to which 
cartridges are to be initialized, label name, type, etc. There must be 
information entered for each disk cartridge to be initialized. To stop the 
Disk Cartridge Initializer enter a blank after the last cartridge has be 


initialized. 


The following messages will be displayed: 

1. WHICH CARTRIDGE? -~ DCSX* OR LEAVE BLANK TO TERMINATE 
2. VERIFICATION ONLY? - <YES OR NO> 

3, ENTER 6 DIGIT SERIAL NUMBER 

4, ENTER PACK, ID 

5. ENTER CARTRIDGE TYPE - “V, S, OR R> 

6. ENTER JULIAN DATE - “<YYDDD 


7. ENTER OWNER'S NAME 


DISK PACK INITIALTZER 


ee 


GENERAL, 


The DISK PACK INITIALIZER must be used to initialize a disk pack before it can 
be used for the system software. The initializer assigns addresses to the 
appropriate segments and writes a random pattern in the segments to ensure the 
segment is not defective. When a segment is found to be bad, it will be 
relocated into a spare segment. If more than five segments are bad in the 
same cylinder then the remaining bad segments will be removed from the disk 
available table on that pack. If six bad segments are found to be bad within 


the first 64 then the pack cannot be used due to system requirements. 


OPERATION INSTRUCTIONS 


The disk initializer program does not operate under the control of the MCP 


and must be loaded and executed through the cassette reader on the control pancl,. 


Information will be supplied to the initializer through the card reader as to 
which cartridges are to be initialized, label name, type, etc. There must be 
one input card for each disk cartridge to be initialized followed by an ?END 


card. The following is a description of the input card. 


1 Drive character (A-~P) 
2 V = Verify only 
blnak = initialize and verify 
3-8 Disk cartridge serial number 
10-19 Label 
21 TYPE 
S = System 


U = Unrestricted 
R = Restricted 
93227 Julian date (YYDDD) 
29-42 I Remarks (Owner's name) 


QF, QP 


The Program Parameter Parser of the Control Language Processor in the MCP 
has been extended slightly in the MCPII 4.1 version. 


"co", "EX', "BI", "MO", "Dy' control statements permit modification of 
Program parameters. "QF" and "QP" (standing for, but not substitutable 
by "QUERYFILE" and "Query Program") permit interrogation of Program 
Parameters, 


QF<CODE, FILE. NAME>“PROGRAM, PARAMETER, INTERROGAT LON. STATEMENT. LIST™ will 
interrogate mother copy parameters, 


QPSJOB.NUMBER><P.P.1.S.L> will interrogate working (log) copy parameters. 


The <P.P.1.S.L> is much like the <P,.P.MODIFICATION.S.L> employed in the five 
PROGRAM, PARAMETER, MODIFICATION. STATEMENTS , excepts where a P.P,MODIFICATION 
was achieved by using a ''NAME/VALUE" pair (e.g., INTERP=GLUMPH), the 

P,P. INTERROGATION will use only the NAME of the parameter. (e.g. "“INTERP") 


Where a P.P,MODIFICATION used only a value (e.g. "DISK"), the P.P. INTERROGATION 
used ANY POSSIBLE VALUE (e.g. "PAPER. TAPE.PUNCH"). 


Examples: 


QF<FN7 IN PR FIQ NAME DISK; ID INTERP 
Will cause to be typed on the SPO (with appropriate preambles, etc.);: 


INTERP NAME 

RUN TIME PRIORITY 

FILE Q'S EXTERNAL NAME 

FILE Q'S DEVICE TYPE 

NAME OF INTRINSIC DIRECTORY 

INTERP NAME (AGAIN) 

as represented in the mother copy cof code file "FN" on the disk. 


Oo ul & & db 
es 


"QP<JOB.NO#"' will do the same thing but with respect to a "working copy" of 
program parameters associated with the particular instance of the CODE-File's 
execution. 


Notes: 
Out of contest interrogations (e.g. "QFN LI") will cause the MCP to complain. 
It makes sense to interrogate certain parameters which it does not make sense 


to modify. (e.g. "COMPILER NAME'') hopefully the syntax to provide these will 
be added soon (but I doubt in 4.1). 
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Burroughs Corporation 


TO: 


“CORPORATE UNIT LOCATION 
Computer Systems Group Santa Barbara 


Programming Activity 


PRINTED 


FROM 


0d Bui build 


INTER-OFFICE CORRESPONDENCE 


October 7, 1974. 


SUBJECT: 


HARDWARE TYPES 


, DEPT. & LOCATION 
Ben Patterson Operating Systems 


c.c. 


Due to resent changes, I am publishing an up-to-date list of Hardware Types: 


DEVICE 


80 Col. READER-PUNCH-PRINTER 
80 Col. PUNCH 

96 Col, READER-PUNCH 

MFCU 

96 Col. READER~PUNCH-PRINTER | 
PAPER TAPE READER 

PAPER TAPE READER-1 

PRINTER 

READER SORTER-2 

READER SORTER 

DISK FILE (ANY HEAD-PER-TRACK DFC-1, DFC-3) 
DFC-1 (1C, 1A, SYSTEM MEMORY) 
DPC-3 (DCC-2) 

DPC-1 (DCC-1) 

DPC-2 (DISK PACK) 

DISK-PACK (DPC-1, DPC-2, DPC-3) 
DISK (ANY DISK) 

DFC-3 (5-N, 5-R) 

96 Col. READER 

PAPER TAPE PUNCH 

80 Col, READER 

SPO 

TAPE 9 TRK. NRZ 

TAPE 7 TRK. 

TAPE PHASE ENCODED 

TAPE (ANY AVALLABLE TAPE) 

TAPE (ANY 9 TRK, OR PHASE ENCODED) 
CASSETTE 

QUEUE FILE 

REMOTE 
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